UUENCODE

Section: User Commands (1)
Updated: 17 July 1987
Index Return to Main Contents
 

NAME

uuencode,uudecode - encode/decode a binary file for transmission via (plain text) mail  

SYNOPSIS

uuencode [source] remotedest | mail sys1!sys2!..!decode
uuencode >outfile.uue source remotedest
uuencode >outfile.uue <source remotedest
uudecode [file]  

DESCRIPTION

Uuencode and uudecode are used to send a binary file via uucp (or other) mail. This combination can be used over indirect mail links even when uusend(1C) or other direct binary transmission methods are not available.

Uuencode takes the named source file (default standard input) and produces an encoded version on the standard output. The encoding uses only printing ASCII characters, and includes the mode of the file and the remotedest for recreation on the remote system.

Uudecode reads an encoded file, strips off any leading lines added by mailers, and recreates the original file with the specified mode and name. If there are other uuencoded files in the same input, they will be decoded as well.

The intent is that all mail to the user ``decode'' should be filtered through the uudecode program. This way the file is created automatically without human intervention. This is possible on the uucp network by either using sendmail or by making rmail be a link to Mail instead of mail. In each case, an alias must be created in a master file to get the automatic invocation of uudecode.

If these facilities are not available, the file can be uudecoded manually.

The encode file has an ordinary text form and can be edited by any text editor to change the mode or remote name.

This version of uuencode automatically adds checksums to each line, and an overall file size to the end. Old versions of uudecode will ignore this extra information, new versions will check it and complain if it is in error.  

SEE ALSO

uuencode(5), uusend(1C), uucp(1C), uux(1C), mail(1)  

AUTHOR

Mark Horton
Checksums and Amiga port by Alan J. Rosenthal
More fixes by Fred Fish
File size check and various refinements by Bryce Nesbitt  

BUGS

The file is expanded by 35% (3 bytes become 4, plus control information) causing it to take longer to transmit.

The user on the remote system who is invoking uudecode (often uucp) must have write permission on the specified file


 

Index

NAME
SYNOPSIS
DESCRIPTION
SEE ALSO
AUTHOR
BUGS

This document was created by man2html, using the manual pages.
Time: 00:29:57 GMT, January 03, 2023